home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / showlog.zip / SHOWLOG.DOC < prev    next >
Text File  |  1992-03-20  |  11KB  |  245 lines
  1. Showlog v1.04
  2.  
  3.            ┌───────────────────────────────────────────────────────┐
  4.        │  L I C E N C E   T E R M S   &   C O N D I T I O N S  │
  5.            └───────────────────────────────────────────────────────┘
  6.  
  7. SHOWLOG is copyright and has been released for distribution as SHAREWARE by 
  8. EGJ Computer Services Ltd. and is the property solely of that company.
  9.  
  10. You are granted a temporary licence to use this program for evaluation only.
  11. If you wish to use it beyond a 2 week period, you must register such use
  12. and pay the registration fee required. A form is provided for this purpose at
  13. the end of this documentation. Please register to support continued development.
  14.  
  15. You are granted permission to distribute this software to any person or
  16. organisation, including commercial or private bulletin boards, by any means
  17. available provided that:
  18.  
  19.     1) The software is distributed without alteration of any kind whatsoever.
  20.  
  21.     2) The software is distributed with all the files which are provided,
  22.        including registration, licence and copyright notices.
  23.  
  24.     3) The copyright notices are acknowledged in any reviews of the product,
  25.        whether published or private.
  26.  
  27.     4) The software is not reverse engineered to examine its working
  28.        whether out of interest, educational purpose or for commercial gain,
  29.        any such gains being the right of the copyright holder.
  30.  
  31. Additionally, in use:
  32.  
  33.     5) No liability for damage, injury or loss, however caused, whether actual
  34.        or implied is accepted by the author or the company EGJ Computer
  35.        Services Ltd. from the use of, or storage of, this software.
  36.  
  37.     6) No guarantee of correctness is offered in respect of the software or its
  38.        documentation.
  39.  
  40. When registered:
  41.  
  42.     7) You may use this software on one computer only for the benefit of its
  43.        users. Multiple uses of a single registered or expired evaluation copy
  44.        of this program is theft.
  45.  
  46.     8) Technical support is available by post; Reports of faults or suggested
  47.        enhancements will be considered for possible future versions which will
  48.        be available to registered users for the cost of the postage and disc.
  49.  
  50. ShowLog v1.04
  51.  
  52.              ┌────────────────────────────────────────────────────┐
  53.              │   T h e   S h a r e W a r e   P r i n c i p l e.   │
  54.              └────────────────────────────────────────────────────┘
  55.  
  56.      ShareWare is the term given to software which is distributed on a
  57. "try-before-you-buy" basis, allowing full operational evaluation before
  58. parting with the money. This allows for accurate selection of the software
  59. which you need and lets the software speak for itself. Also, by allowing
  60. un-restricted distribution, the overall marketing costs are much reduced
  61. leading to a much lower price overall.
  62.  
  63.      However, the product DOES have a cost, it is NOT FREE and the
  64. registration fee must be paid if the product is used beyond the evaluation
  65. period. Doing otherwise is THEFT and will likely lead to the number of
  66. programs available by this means becoming smaller and smaller.
  67.  
  68.      At registration, you also receive the latest version, technical support
  69. and can make your comments and suggestions which can lead to improvements or
  70. even another useful program.
  71.  
  72.         Please co-operate and register now to gain the full benefits.
  73.  
  74.  
  75. Showlog v1.04
  76.  
  77.                      ┌───────────────────────────────────┐
  78.                      │  R e f e r e n c e   M a n u a l. │
  79.                      └───────────────────────────────────┘
  80.  
  81. Introduction
  82.  
  83.      The purpose of this program is to search and select information from the
  84. BACKUP.LOG file created during a disc backup, aiding both the management of
  85. the backup disc set and the process of file resoration. By use of the command
  86. options, the exact location of a particular file within the existing backup
  87. set discs can be identified. The full details for the files which match the
  88. selection criteria will be displayed.
  89.  
  90.  
  91. Command line syntax.
  92. ────────────────────
  93.  
  94.     SHOWLOG [-options] [pattern]
  95.  
  96.     where
  97.         OPTIONS are single letter options, described below, some of
  98.                 which take immediate values which must be given following
  99.                 the option letter without any spaces. eg.
  100.  
  101.                 -Ca:
  102.                 -P\filepath\filename
  103.  
  104.         PATTERN is the filename pattern to be matched in a search of
  105.                 the logfile. If it is omitted, the filename part of the
  106.                 filepath on each line of the logfile will not be used during
  107.                 of the search and selection.
  108.  
  109. Command options
  110. ────────────────
  111.  
  112.     -C    Takes a disc identifier value.  When given, this option will
  113.                 cause the latest backup set entry in the file to be copied
  114.                 to a valid backup log file in the root directory of the
  115.                 specified disc, if sufficient space exists.
  116.  
  117.         This is particularly useful in allowing the latest backup log
  118.                 entry to be copied to the last disc in a newly created backup
  119.                 disc set, when normally no record of the contents of a
  120.                 backup set is kept within that disc set.
  121.  
  122.         This option is mutually exclusive with the -R option.
  123.  
  124.  
  125.     -D    Takes a 3 digit string numeric value. This allows the search
  126.                 to be restricted to those discs with the same sequence number
  127.                 as given here. The string numeric value must have leading
  128.                 zeroes spoecified to ensure that exactly 3 characters are
  129.                 given. The search pattern matching is restricted to disc
  130.                 entries with this number. By default, the search will cover
  131.                 and display all matching discs.
  132.  
  133.         When given, this option automatically enables the -S option.
  134.  
  135.  
  136. ShowLog v1.04
  137.  
  138.     -F    Takes a file path value. This allows the program to operate
  139.                 on an alternative log file, specified entirely by this option.
  140.                 Normally the log file is expected to be present in the root
  141.                 directory of the currently logged disc and have the
  142.                 name BACKUP.LOG.
  143.  
  144.     -P    Takes a string value. This allows the specification of a
  145.                 search pattern which matches only in the directory tree part
  146.                 of file names found in the backup file. Only lines with a
  147.                 successful match become a part of the display.
  148.  
  149.         When given, this option automatically enables the -S option.
  150.  
  151.  
  152.     -R    Takes a date value. All backup records preceding this date
  153.                 are removed from the backup log. This is most useful in
  154.                 preventing the log file from growing enormous, particularly
  155.                 when the older backup disc sets no longer exist but have
  156.                 been over-written in later cycles.
  157.  
  158.         If the specified date is not found, the backup file remains
  159.                 unchanged.
  160.  
  161.         This option is mutually exclusive with the -C option.
  162.  
  163.  
  164.     -S    The show option. If used without a search pattern, will
  165.                 produce a display consisting of the dates of all backup sets
  166.                 recorded in the backup log file.
  167.  
  168.         When a search pattern is given, all lines in the file which
  169.                 match the pattern in any way are displayed alongside the
  170.                 backup set disc number on which the file is to be found.
  171.  
  172.  
  173. Program Output.
  174.  
  175.     When a pattern match is found, the first line of the display consists
  176. of the date of the backup set, the sequence number of the disc and full file
  177. path of the matched file. Subsequent lines from the same backup set are
  178. displayed without a date, but the disc and file columns remain aligned.
  179.  
  180.     The program is compatible with the usual command line re-direction
  181. capability provided by DOS. The screen output can be sent to a device or
  182. disc file, as desired, although any error messages encountered during
  183. processing will still appear on the screen device.
  184.  
  185.     The program may be used within a batch file, returning an error
  186. status if a fault is detected, and a success status if the operation
  187. completed su